File-Finder v1.13pl4 áeta (8 Dec 1996)

                       AllFix File Finder System
                        FreeWare - Don't buy it!

                    (C)opyright 1993-1996 M.J. Matts

                       Written by M.J. Matts, new
                       development by Darren Hook


What is File-Finder?
ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 An easy to use network utility to enable users to search for the 
 existance and location of files simply by sending out a networked 
 message. It offers support for many varied formats of file description 
 data files used by many BBS packages.


How?
ÿÿÿÿ
 To use File-Finder you must create a config file (or edit the example) 
 named FILEFIND.CFG which must reside in the same folder as the main 
 FILEFIND.TOS file. This config file will enable File-Finder to know 
 where to search for files, what information about your system will be 
 placed into replies to enable a user to easily access your system 
 along with other things such as paths etc..

 The following are all the commands available for use within the config 
 file:


 SYSOP <your name>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies.

 Example: Sysop Mark Matts


 SYSTEM <your BBS or mail system's name>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies.

 Example: System System ST


 LOCATION <your location>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies.

 Example: Location Leicester, UK


 PHONE <your telephonr number>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies.

 Example: Phone +44 (0)533 413443


 BAUD <your systems baud rate>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies.

 Example: Baud 1200/2400/9600


 TIMES <your online times>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies.

 Example: Times 10pm to 7am


 ADDRESS <network address>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Used for information in replies. You can define upto 10 different 
 addresses.

 Example: Address 90:100/101.0


 MSGBASE <path & filename (no extender) to File-Finder msg base>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Tells File-Finder which message base to scan for File-Finder messages 
 and also where to reply to them. **NOTE** Please make sure this 
 message base has been setup specifically to operate as a file finder 
 system. On the NeST network the base used for this purpose is called 
 N_ALLFIX and should be available from most mailer systems. By defining 
 multiple message bases (upto 10) you can run File-Finder on different 
 networks... See config file for example of multiple msgbase commands.

 Example: MsgBase F:\NESTWARE\FILEFIND\MSGBASE\N_ALLFIX


 FINDERNAME <name of TO: field to respond to>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Tells File-Finder what to check for and react to when scanning for 
 request messages. You can define upto 10 different File-Finder names. 
 Please note that this command is *NOT* case sensitive so ALLFIX is 
 treated the same as allfix. ALLFIX and FILEFINDER are default settings 
 so this command is only needed when other finder names are to be used.

 Example: Findername AllFix


 LOGFILE <path & filename to log File to use>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Tells File-Finder which file to use for logging it's activity. A 
 BinkleyTerm format is used with FFDR as the text identifier. Log 
 entries will only be made if File-Finder actually does anything.

 Example: LogFile F:\BINKLEY\BINKLEY.LOG


 MAXDESC <maximum number of description to allow in a reply>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Forces File-Finder not to include any more than the given number of 
 descriptions in a reply message. This should hopefully avoid any 
 excessively large messages being sent into the networks. The maximum 
 setting is 15 which is also the default so this option is only of use 
 if you wish to cut down the limit since you cannot increase it above 
 15. This limit also applies to replies sent to a description request.

 Example: MaxDesc 10


 LOCK <filename>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Allows you to lock a named file from being included in a File-Finder 
 reply. You can define upto 100 locked files.

 Example: Lock PRIVATE.LZH


 FROMSYSOP
 ÿÿÿÿÿÿÿÿÿ
 All replies sent out from your system will be addressed from your 
 sysop name as defined by the SYSOP command instead of the default 
 File-Finder.


 FROMSYSTEM
 ÿÿÿÿÿÿÿÿÿÿ
 All replies sent out from your system will be addressed from your 
 system name as defined by the SYSTEM command instead of the default 
 File-Finder.


 SCANALL
 ÿÿÿÿÿÿÿ
 Forces File-Finder to scan the entire message base each time it is run 
 rather then from the last read message.


 ACCESS (followed by parameters relevant to your BBS package)
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 The first parameter will tell File-Finder which path to search for 
 files which match the requested filename. You can define upto 300 
 different paths. The parameters enclosed in the square & curly 
 brackets are optional and is only used for information purposes and 
 may differ depending on the BBS setting used. If a file is found in 
 the path given it will be listed as being in the area defined within 
 the square brackets. Please refer to the above BBS commands which will 
 be suitable for you.

 Example: Access I:\COMMS\ [Communications Software] {comms}


 The following commands each make File-Finder look for different 
 description files which are used by the relevant BBS package named. 
 You may mix the BBS name commands if your system uses more than just 
 one type. Depending on the type of BBS named the format of the ACCESS 
 command will be slightly different so please take the time to read 
 which format your setup uses.


 QUICKBBS
 ACCESS <path to file area> <[Area description]>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search a FILES.BBS file (in 
 QuickBBS format) in the path defined by the first parameter of the 
 relevant ACCESS commands.

 Example: QuickBBS
          Access I:\COMMS\ [Communications Software]


 TURBO <path to *.FIL files>
 ACCESS <path to file area> <[Area description]> <{FIL name}>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search the given path for any FIL 
 files named for each area. (TurboBoard v2 format)

 Example: Turbo H:\TURBO\DATA\
          Access I:\COMMS\ [Communications Software] {comms}


 FOREM
 ACCESS <path to file area> <[Area description]> <{DIR name}>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search in the path given in each 
 access command for the named DIR file for each area.

 Example: Forem
          Access I:\COMMS\ [Communications Software] {comms}


 STKEEP
 ACCESS <path to file area> <[Area description]>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search in the FILES folder which 
 should be in the path defined by the first parameter of the relevant 
 ACCESS commands.

 Example: STKeep
          Access I:\COMMS\ [Communications Software]


 EXPRESS
 ACCESS <path to file area> <[Area description]>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search in the DESC folder which 
 should be in the path defined by the first parameter of the relevant 
 ACCESS commands.

 Example: Express
          Access I:\COMMS\ [Communications Software]


 WIZFILE <path & filename of WIZfile description file>
 ACCESS <path to file area> <[Area description]>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search the file list created by 
 WIZfile, however, the file must be in the format produced by pre 
 WIZfile v1.30.

 Example: WIZFile H:\WIZFILE\ALLFILE.TXT
          Access I:\COMMS\ [Communications Software]


 NEWWIZFILE <path & filename of WIZfile description file>
 ACCESS <path to file area> <[Area description]>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 This keyword will make File-Finder search the new format of file list 
 created by WIZfile v1.03 using the -F option.

 Example: NewWIZFile H:\WIZFILE\FILES.BBS
          Access I:\COMMS\ [Communications Software]


 RATSOFT <path to main RATSoft folder (CONFIG.DAT)>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Using this command you will NOT need to define any ACCESS commands, 
 all the ACCESS paths and area descriptions will be taken directly from 
 the RATSoft environment which is found by using the path after this 
 command.

 Example: RatSoft H:\RATSOFT\


 RATLEVEL <maximum file/area level to scan>
 ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ
 Only to be used in association with RATSOFT. Limits the files/areas to 
 be scanned according to the access level set. Default is 254 (ie 255 
 sysops only areas will be ignored).

 Example: RatLevel 200


 PLEASE NOTE. IF YOU WOULD LIKE TO HAVE YOUR BBS PACKAGE SUPPORTED 
 PLEASE SEND ME THE STRUCTURES AND AN EXAMPLE OF ANY FILE(S) WHICH HOLD 
 THE FILE DESCRIPTIONS PLUS OTHER INFO WHICH WILL HELP ME.


 That's all there is to it! You can specify both any of the BBS name 
 commands if your system uses a mixture of both formats, ideal for 
 multiBBS systems. A check will be made for both file formats in each 
 area and the description will be taken from the first one found.

 If File-Finder writes a reply to any File-Find enquiries it will exit 
 with an errorlevel of 1 therefore allowing you to run your exporter if 
 needed. An errorlevel of 0 is used in all other instances.


Support!
ÿÿÿÿÿÿÿÿ
 As from version 1.09 àlpha, I have permission from Mark Matts to 
 continue development of File-Finder. He still retains copyright!!

 If you have any problems or ideas, please contact me, Darren Hook - 
 the current developer - via any of the following addresses:

     Internet:   dhook@dcs.qmw.ac.uk
                 dhook@mettav.demon.co.uk
     Fidonet:    2:254/108.4@fidonet.ftn
     NeST:       90:102/151.0@nest.ftn
     AtariNet:   51:502/100.4@atarinet.ftn
     Turbonet:   100:1011/4.0@turbonet.ftn

 Enjoy...